home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / fade into you / being there / How To & FAQ's / ftpmail - how to < prev    next >
Text File  |  1994-11-11  |  13KB  |  429 lines
  1.  
  2.  
  3. Welcome to the University of Wollongong MAIL to FTP gateway.
  4.  
  5. This message is the response the gateway sends when it does
  6. not understand your request.
  7.  
  8. The gateway is a simple attempt to provide a service to those
  9. people who have electronic mail but no access to Internet
  10. for FTP.
  11.  
  12. Requests
  13. ========
  14.  
  15.     To access the gateway send mail to
  16.  
  17.     ftpmail@cs.uow.edu.au
  18.  
  19. The gateway software will examine the body of your mail item
  20. (headers are ingored) and try to determine what machine you
  21. wish to access and what file you want fetched.
  22.  
  23. It also implements a interface to the "archie" system
  24. for locating files available for anonymous ftp.
  25. Archie searches a database of files available for
  26. ftp from a list of major archive sites.
  27.  
  28. For example, you may know of a product called
  29. "amd" but not know where it is available on the
  30. Internet. You could use the "archie" command to find out
  31. where a copy of "amd" is available. Some information on using the
  32. "archie" command is enclosed at the end of this document.
  33.  
  34. Using FTPMAIL
  35. ============
  36.  
  37. Normally, ftpmail attempts to connect with the target machine as an anonymous
  38. ftp user. It is possible to override the user name ftpmail will use for the
  39. connection as well as specify a password (see below).
  40.  
  41. If the above step is successful it then attempts the transfer in binary
  42. mode and if successful mails the files to you. All files are sent uuencoded.
  43. If the file is large it is split into smaller pieces and
  44. each piece is sent separately.
  45.  
  46. Each request for a FTP action must contain a single
  47. line of the form
  48.  
  49. HOST hostname
  50.  
  51. to specify the remote host you wish to access. The "hostname" field above
  52. may be a INTERNET style domain name or an IP address in dotted notation.
  53. Wherever possible, names should be used rather than IP numbers.
  54. You may only have a single "HOST" line per FTPMAIL request.
  55. If using dotted decimal notation, do not enclose the address inside
  56. [] style brackets.
  57.  
  58. To specify the file to transfer your request must contain
  59. a line of the form
  60.  
  61. GET filename-1 filename-2 ........
  62.  
  63. Each request can only contain one GET command but each GET command
  64. may specify several file names.
  65.  
  66. If you wish to list the files available on a remote machine
  67. your request should contain a line of the form
  68.  
  69. DIR directory-1 directory-2 .......
  70.  
  71. A request may contain only one of either a GET or a DIR line.
  72.  
  73. If you have a problem send mail to ftpmail-adm@cs.uow.edu.au
  74. or the postmaster. The system is experimental and probably contains
  75. many bugs. If you find a bug, please notify the above address so
  76. it can be fixed.
  77.  
  78. Ftpmail normally sends fetched files back to you as a series
  79. of shell archives. If you are not on a UNIX system
  80. (my condolences) you may specify you want the uuencoded segments
  81. "raw" by specifying a line of the form
  82.  
  83. PLAINMAIL
  84.  
  85. in your request. In this case you may combine the uuencoded segments
  86. by hand. There is no way to avoid the uuencoding or the
  87. splitting of large files.
  88.  
  89.  
  90. Large files are split into small pieces to avoid problems
  91. with mailers that cannot handle large files. The default
  92. chunksize is 60K. Users may override the default chunksize
  93. with the CHUNKSIZE keyword. The number specified with the
  94. CHUNKSIZE keyword is the size in Kilobytes. For example,
  95.  
  96. CHUNKSIZE 200
  97.  
  98. included in the mail body will set the chunksize to 200K bytes.
  99. The lower limit on the chunksize is 20K and the upper limit
  100. is 200K. CHUNKSIZE may be specified along with the PLAINMAIL
  101. keyword.
  102.  
  103.  
  104.  
  105. Using a specified user name
  106. ===========================
  107.  
  108. Ftpmail allows the user to specify the user name and password
  109. to use for the connection. If you use this facility remember that
  110. the password you specify appears in the mail item as PLAIN
  111. TEXT. Mail is not secure so sending plain text passwords should be
  112. used with extreme caution. In general, only publicly available
  113. passwords should be sent in this manner.
  114.  
  115. The commands for specifying a user name and password are
  116.  
  117. USER username      (no spaces allowed)
  118.  
  119. and
  120.  
  121. PASSWORD password     (no spaces allowed)
  122.  
  123. Ftpmail will attempt to connect to the specified server
  124. (from the HOST command) and use the specified user name
  125. and password.
  126.  
  127.  
  128. Using ARCHIE
  129. ============
  130.  
  131. If your request contains a line of the form
  132.  
  133. ARCHIE parameters
  134.  
  135. then ftpmail will invoke the "archie" command with the parameters
  136. specified. For example, if you sent mail containing the line
  137.  
  138. ARCHIE amd
  139.  
  140. then ftpmail will invoke "archie" with the argument amd.
  141.  
  142. The output from the command is mailed back exactly as it
  143. is printed by the "archie" command.
  144.  
  145. The man page for "archie" follows.
  146.  
  147.  
  148.  
  149.  
  150.  
  151. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  152.  
  153.  
  154.  
  155. NAME
  156.      archie - query the  Archie  anonymous  FTP  databases  using
  157.      Prospero
  158.  
  159. SYNOPSIS
  160.      archie [ -cers ] [ -a ] [ -l ] [ -t ] [ -m hits ] [ -N level ] [ -h hostname ]
  161.              [ -o filename ] [ -L ] [ -fB-V ] string
  162.  
  163. DESCRIPTION
  164.      archie queries an archie anonymous FTP database looking  for
  165.      the  specified  string  using  the  Prospero protocol.  This
  166.      client is based on Prospero version Beta.4.2 and is provided
  167.      to  encourage non-interactive use of the Archie servers (and
  168.      subsequently better performance on both  sides).   This  man
  169.      page describes version 1.3 of the client.
  170.  
  171.      The general method of use is of the form
  172.  
  173.           % archie string
  174.  
  175.      This will go to the archie server and ask it to look for all
  176.      known  systems  that have a file named `string' in their FTP
  177.      area.  archie will wait, and print out any matches.
  178.  
  179.      For example,
  180.  
  181.           % archie emacs
  182.  
  183.      will find all anonymous FTP sites  in  the  archie  database
  184.      that  have  files  named  emacs somewhere in their FTP area.
  185.      (This particular query would probably return a lot of direc-
  186.      tories.)  If you want a list of every filename that contains
  187.      emacs anywhere in it, you'd use
  188.  
  189.           % archie -c emacs
  190.  
  191.      Regular expressions, such as
  192.  
  193.           % archie -r '[xX][lL]isp'
  194.  
  195.      may also be used for searches.  (See the manual of a reason-
  196.      ably good editor, like GNU Emacs or vi, for more information
  197.      on using regular expressions.)
  198.  
  199.  
  200. OPTIONS
  201.      The options currently available to this archie client are:
  202.  
  203.      -c          Search substrings paying attention  to  upper  &
  204.                  lower case.
  205.      -e          Exact string match.  (This is the default.)
  206.      -r          Search using a regular expression.
  207.  
  208.  
  209.  
  210. Archie (Prospero)  Last change: 9 January 1992                  1
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  218.  
  219.  
  220.  
  221.      -s          Search  substrings  ignoring  the  case  of  the
  222.                  letters.
  223.      -ofilename  If specified, place the results of the search in
  224.                  filename.
  225.      -a          Output results as Alex filenames.
  226.      -l          Output results in a form suitable for parsing by
  227.                  programs.
  228.      -t          Sort the results inverted by date.
  229.      -mhits      Specifies the maximum number of  hits  (matches)
  230.                  to return (default of 95).
  231.      -Nlevel     Sets the niceness of a query; by  default,  it's
  232.                  set  to 0.  Without an argument, ``-N'' defaults
  233.                  to 35765.   If  you  use  -N  with  an  argument
  234.                  between 0 and 35765, it'll adjust itself accord-
  235.                  ingly.  (Note: VMS users will have to put quotes
  236.                  around  this  argument, and -L, like "-N45"; VMS
  237.                  will otherwise convert it to lowercase.)
  238.      -h hostname Tells the client  to  query  the  Archie  server
  239.                  hostname.
  240.      -L          Lists the Archie servers known  to  the  program
  241.                  when it was compiled, as well as the name of the
  242.                  default Archie server.  For an up-to-date  list,
  243.                  write  to  ``archie@archie.mcgill.ca''  (or  any
  244.                  Archie  server)  with  the  single  command   of
  245.                  servers.
  246.      -V          With the verbose option, archie will  make  some
  247.                  comments  along  the way if a search is going to
  248.                  take some time, to pacify the user.
  249.  
  250.      The three search-modifying arguments  (``-c'',  ``-r'',  and
  251.      ``-s'')  are  all  mutually  exclusive;  only  the  last one
  252.      counts.  If you specify -e with any of  ``-c'',  ``-r'',  or
  253.      ``-s'', the server will first check for an exact match, then
  254.      fall back to the case-sensitive, case-insensitive, or  regu-
  255.      lar expression search.  This is so if there are matches that
  256.      are particularly obvious, it will take a minimal  amount  of
  257.      time to satisfy your request.
  258.  
  259.      If you list a single `-' by itself,  any  further  arguments
  260.      will  be  taken  as  part  of  the  search  string.  This is
  261.      intended to enable searching for strings that begin  with  a
  262.      `-'; for example:
  263.  
  264.           % archie -s - -old
  265.  
  266.      will search for all filenames that contain the string `-old'
  267.      in them.
  268.  
  269. RESPONSE
  270.      Archie servers are set up to respond to a number of requests
  271.      in  a  queued fashion.  That is, smaller requests get served
  272.      much more quickly than do large requests.  As a result,  the
  273.  
  274.  
  275.  
  276. Archie (Prospero)  Last change: 9 January 1992                  2
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  284.  
  285.  
  286.  
  287.      more  often  you query the Archie server, or the larger your
  288.      requests, the longer the queue will become, resulting  in  a
  289.      longer  waiting  period  for everyone's requests.  Please be
  290.      frugal when possible, for your benefit as well  as  for  the
  291.      other users.
  292.  
  293. QUERY PRIORITY
  294.      Please use the  ``-N''  option  whenever  you  don't  demand
  295.      immediacy,  or when you're requesting things that could gen-
  296.      erate large responses.  Even when using the nice option, you
  297.      should  still  try  to  avoid  big jobs during busy periods.
  298.      Here is a list of what we consider to be  nice  values  that
  299.      accurately reflect the priority of a job to the server.
  300.  
  301.           Normal              0
  302.           Nice                500
  303.           Nicer               1000
  304.           Very Nice           5000
  305.           Extremely Nice      10000
  306.           Nicest              32765
  307.  
  308.      The last priority, Nicest, would be used when a  job  should
  309.      wait  until  the  queue is essentially empty before running.
  310.      You should pick one of these values to use, possibly modify-
  311.      ing  it  slightly depending on where you think your priority
  312.      should land.  For example, 32760 would mean wait  until  the
  313.      queue  is  empty,  but  jump  ahead  of other jobs that have
  314.      selected Nicest.
  315.  
  316.      There are certain types of  things  that  we  suggest  using
  317.      Nicest  for,  irregardless.  In particular, any searches for
  318.      which you would have a hard time justifying the use of  any-
  319.      thing but extra resources.  (We all know what those searches
  320.      would be for.)
  321.  
  322. ENVIRONMENT
  323.      ARCHIE_HOST
  324.              This will change the host archie will  consult  when
  325.              making  queries.   (The default value is what's been
  326.              compiled in.)  The ``-h'' option will override this.
  327.              If  you're  running  VMS,  create  a  symbol  called
  328.              ARCHIE_HOST.
  329.  
  330. SEE ALSO
  331.      For more information on regular expressions, see the  manual
  332.      pages on:
  333.  
  334.      regex(3), ed(1)
  335.  
  336.      Also   read    the    file    archie/doc/whatis.archie    on
  337.      archie.mcgill.ca for a detailed paper on Archie as a whole.
  338.  
  339.  
  340.  
  341.  
  342. Archie (Prospero)  Last change: 9 January 1992                  3
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  350.  
  351.  
  352.  
  353.      Read the file README.ALEX distributed with this  client  for
  354.      more information on what Alex is and how you can take advan-
  355.      tage of it.
  356. AUTHORS
  357.      The archie service was conceived  and  implemented  by  Alan
  358.      Emtage       (bajan@cs.mcgill.ca),       Peter       Deutsch
  359.      (peterd@cs.mcgill.ca),        and        Bill         Heelan
  360.      (wheelan@cs.mcgill.ca).   The  entire  Internet  is in their
  361.      debt.
  362.  
  363.      The  Prospero  system  was  created   by   Clifford   Neuman
  364.      (bcn@isi.edu);   write  to  info-prospero@isi.edu  for  more
  365.      information on the protocol and its use.
  366.  
  367.      This stripped client  was  put  together  by  Brendan  Kehoe
  368.      (brendan@cygnus.com),  with modifications by Clifford Neuman
  369.      and George Ferguson (ferguson@cs.rochester.edu).
  370.  
  371. BUGS
  372.      There are none; only a few unexpected features.
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408. Archie (Prospero)  Last change: 9 January 1992                  4
  409.  
  410.  
  411.  
  412.  
  413.  
  414. ------ Internet Message Header Follows ------
  415. Xref: appleoz aus.general:1936 aus.mail:58 aus.archives:63 aus.aarnet:422
  416. Path: appleoz!tmx!basser.cs.su.oz.au!metro!dmssyd.syd.dms.CSIRO.AU!news.cs.uow.edu.au!news.cs.uow.edu.au!not-for-mail
  417. From: ftpmail@cs.uow.edu.au
  418. Newsgroups: aus.general,aus.mail,aus.archives,aus.aarnet
  419. Subject: ftpmail - automatic monthly posting
  420. Date: 25 Nov 1993 11:13:03 +1100
  421. Organization: University of Wollongong
  422. Lines: 428
  423. Sender: root@wraith.cs.uow.edu.au
  424. Distribution: aus
  425. Message-ID: <2d0taf$97s@wraith.cs.uow.edu.au>
  426. Reply-To: ftpmail@cs.uow.edu.au
  427. NNTP-Posting-Host: wraith.cs.uow.edu.au
  428.  
  429.